# Drakengard 3 — Traduzione italiana (RPCS3)

**Gioco:** Drakengard 3, versione USA `BLUS31197`, aggiornamento **1.01** · **Emulatore:** RPCS3 · **DLC:** `NPUB31251` (facoltativo)

Questa traduzione **non contiene file del gioco**: contiene solo il testo italiano (`data/unique.csv`)
e gli strumenti che lo applicano alla *tua* copia del gioco. Ti serve una copia legale del gioco.

## Cosa viene tradotto
Tutti i dialoghi e i sottotitoli, i menu, i tutorial, gli obiettivi di missione, il database
e l'archivio, le storie delle armi, le richieste di Accord, i riepiloghi dei capitoli e tutti i DLC.
Restano in inglese i titoli di coda (nomi e ruoli) e alcune scritte che nel gioco sono immagini.

## Requisiti
- RPCS3 con il gioco installato e l'**aggiornamento 1.01**
- **Python 3** (su Linux di solito è già presente; su Windows: python.org)
- Solo se usi le texture tradotte: `pip install pillow`

## Scegli come giocare
| Voglio... | Comandi |
|---|---|
| Italiano, grafica originale | `./install.sh` |
| Italiano + HUD in alta risoluzione | `./install.sh --hd`, poi `hud/hud.sh` per ogni pacchetto (sezione HUD) |
| Inglese + HUD in alta risoluzione | `./install.sh --lang=en`, poi `hud/hud.sh` per ogni pacchetto |
| Tornare tutto all'originale | `./install.sh --restore` e `./hud/hud.sh restore <PACCHETTO>` |

Le immagini tradotte (cartello del negozio, poesie dei titoli di coda, "Premi START") sono a risoluzione doppia:
senza `--hd` vengono ridotte automaticamente alla dimensione originale.

## Installazione — Linux
```
./install.sh
```
Lo script trova da solo la cartella di RPCS3 (anche Flatpak) e il gioco (da `games.yml`).
Se non li trova: `./install.sh --rpcs3=/percorso/rpcs3 --game=/percorso/Drakengard 3`
(`--rpcs3` = la cartella che contiene `dev_hdd0`, `--game` = la cartella che contiene `PS3_GAME`).

## Installazione — Windows
Esegui `install_windows.bat` e inserisci i percorsi richiesti.

## Passo finale obbligatorio (menu e riepiloghi)
Alcuni menu e i riepiloghi della storia diventano italiani solo dopo questo passaggio:
1. Scarica **Drakengard-3-Sqex03DataMessage** dalla pagina
   [Releases](https://github.com/lehieugch68/Drakengard-3-Sqex03DataMessage/releases) (Windows; su Linux usa `wine`).
2. Aprilo, carica **la cartella del gioco** e **la cartella HDD del gioco** (`dev_hdd0/game/BLUS31197`), premi **Save**.
3. Cancella la cache: `rm -f ~/.config/rpcs3/dev_hdd1/caches/BLUS31197_BLUS31197/fios/cache.{dat,idx}`
   (su Windows: elimina `cache.dat` e `cache.idx` in `dev_hdd1\caches\BLUS31197_BLUS31197\fios`).
Ripeti questo passo ogni volta che riesegui `install.sh`.

## DLC
1. Installa i pacchetti DLC in RPCS3 (*File → Install Packages/Raps/Edats*).
2. Aggiungi **il tuo file `.rap`** della licenza DLC (stesso menu, oppure copialo in
   `dev_hdd0/home/00000001/exdata/`). Senza `.rap` il gioco non carica i DLC.
3. **Esegui di nuovo `install.sh`**: tradurrà anche i pacchetti DLC appena installati.

## Disinstallazione
```
./install.sh --restore
```
Tutti i file originali vengono salvati in `backup/` al primo avvio: **non cancellare questa cartella**.

## Extra (facoltativi)
- `extras/drakengard3_patches.yml` — patch per RPCS3 (importale da *Manage → Game Patches → Import*):
  - **Ultrawide 21:9 (3440×1440)** — richiede *GPU → Stretch To Display Area*; HUD e menu restano allungati.
  - **Wider FOV +10/+20/+30%** — attivane solo una.
  - **HD UI textures** — serve solo con un mod di texture HUD a risoluzione doppia.
- `data/textures/` — immagini tradotte (es. il cartello del negozio e le poesie dei titoli di coda).
  Metti i PNG qui e i nomi dei pacchetti di destinazione in `targets.txt`.

## HUD in alta risoluzione (facoltativo)
Le texture dell'interfaccia a risoluzione doppia **non sono incluse**: le generi tu dalla tua copia del gioco
con [Upscayl](https://upscayl.org) e lo script `hud/hud.sh`.
1. Importa in RPCS3 la patch **"HD UI textures - keep original UV scale"** (`extras/drakengard3_patches.yml`) e attivala.
2. Per ogni pacchetto (`HUD_BATTLE_SF`, `HUD_TITLE_SF`, `HUD_PAUSE_SF`, `HUD_COMMON_SF`, `HUD_PREPARATION_SF`,
   `HUD_RESULT_SF`, `HUD_BOOK_SELECT_SF`, `HUD_TUTORIAL_SF`, `HUD_STAFFROLL_SF`):
   ```
   ./hud/hud.sh prep HUD_BATTLE_SF
   ```
   poi in Upscayl: cartella `hud/work/HUD_BATTLE_SF/prep` → `hud/work/HUD_BATTLE_SF/up`,
   modello **high-fidelity-4x**, scala **2x**, formato PNG. Infine:
   ```
   ./hud/hud.sh build HUD_BATTLE_SF
   ```
   Le immagini tradotte di `data/textures` (es. "Premi START") vengono inserite automaticamente.
3. Per tornare all'originale: `./hud/hud.sh restore HUD_BATTLE_SF`.

## Problemi
- Se vedi ancora testo inglese dopo l'installazione, chiudi RPCS3 e riesegui `install.sh`.
- Se il gioco non si avvia dopo l'installazione: `./install.sh --restore`, poi segnala il problema.

---

# Drakengard 3 — Italian translation (RPCS3)

**Game:** Drakengard 3 US `BLUS31197`, update **1.01** · **Emulator:** RPCS3 · **DLC:** `NPUB31251` (optional)

This package contains **no game files** — only the Italian text (`data/unique.csv`) and the tools
that apply it to *your own* copy of the game.

**Install:** `./install.sh` (Linux) or `install_windows.bat` (Windows). Requires Python 3 and game update 1.01.
Paths are auto-detected; otherwise pass `--rpcs3=DIR` (folder containing `dev_hdd0`) and `--game=DIR`
(folder containing `PS3_GAME`).

**DLC:** install the DLC packages in RPCS3, add **your own `.rap` license file**
(*File → Install Packages/Raps/Edats*, or copy it to `dev_hdd0/home/00000001/exdata/`), then **run the installer again**.

**Required final step (menus and story summaries):** after installing, open
[Drakengard-3-Sqex03DataMessage](https://github.com/lehieugch68/Drakengard-3-Sqex03DataMessage/releases)
(Windows; `wine` on Linux), load the game folder and the HDD game folder (`dev_hdd0/game/BLUS31197`),
press **Save**, then delete `dev_hdd1/caches/BLUS31197_BLUS31197/fios/cache.dat` and `cache.idx`.
Repeat after every reinstall.

**Modes:** `./install.sh` Italian with original graphics · `./install.sh --hd` Italian + HD HUD (then `hud/hud.sh`) · `./install.sh --lang=en` English + HD HUD (then `hud/hud.sh`).

**Uninstall:** `./install.sh --restore` — originals are kept in `backup/`, don't delete it.

**Extras:** RPCS3 patches in `extras/` (ultrawide 21:9, wider FOV, HD UI); translated textures in `data/textures/`.

**HD HUD (optional):** no upscaled game textures are shipped. Generate them from your own copy: `./hud/hud.sh prep HUD_BATTLE_SF`, upscale `hud/work/<PKG>/prep` → `hud/work/<PKG>/up` in Upscayl (high-fidelity-4x, 2x), then `./hud/hud.sh build HUD_BATTLE_SF`. Needs the "HD UI textures" RPCS3 patch.

## Crediti / Credits
Traduzione e strumenti: *[il tuo nome]* · Formato dei pacchetti di testo documentato anche da
[D3-Sqex03DataMessage](https://github.com/lehieugch68/Drakengard-3-Sqex03DataMessage) (lehieugch68, Oblivion).
Drakengard 3 © SQUARE ENIX. Progetto amatoriale, non affiliato né approvato da Square Enix.